FCS/FCA adapter Configuration/Query CMDs

These commands are used by AIX to configure or query the adapter and any errors may be due to:

device driver
System Error
Adapter firmware
Adapter hardware
System Slot freeze ( look for PCI_RECOVERABLE_ERR or PCI_PERMANENT_ERR in the error log)

Generally, replacing the adapter will not resolve problems with these commands.

When the server issues one of these command to the adapter, the ownership bit in the OS field is set to one and the Status field STST is set to 0xFFFF. When the adapter completes the command, the Status field (STST) is set to a value other than 0xFFFF, and the OS field is cleared.

Command Time- Outs

To verify that this is a command time out, check the OS field and the command status field. If the OS field is 0x00 and the status field (STST) is not 0xFFFF, then the adapter has completed the command and the AIX has missed the interrupt. This is a server / AIX issue.
If the status field (STST) is not 0xFFFF and the OS field is not cleared, this is an adapter hw/fw issue.
Error message FCS_ERR2 0x127 was introduced for the 4G dual port adapter(FC 5758. 1905). The mailbox 0x24 command behavior was changed to quiesce the activity on one port while the other port was to be reset, and the command completion status changed. This change was added to firmware level 2.10x8. If the firmware level is less than 2.10x8, then this message is informational only, if the firmware is 2.10x8 or higher, then this is a command time out.
If the status field (STST) is 0xFFFF and the ownership bit in the OS field is 0x01, then the adapter is not processing the commands,
1. This may indicate a problem with the way the adapter was configured (AIX device driver issue) or it may be an adapter firmware issue.
2. If the adapter is not responsive following a hard reset, this may indicate a problem with the adapter firmware image in the flash. If this image is damaged, the adapter must be replaced.

DETAIL SENSE DATA

DETAIL SENSE DATA
Here below is a cut from the full error log sense template. Click here to see full error template.

AIX Version 5.3 and below

RRRR RRRR EEEE EEEE TTCC OOOO NNNN NNNN NNNN NNNN IIII IIII MMMM MMMM LLLL LLLL
AAAA AAAA BBBB BBBB DDDD DDDD FFFF FFFF GGGG GGGG HHHH HHHH JJJJ JJJJ KKKK KKKK
PPPP PPPP SS%% UUUU VVVV VVVV WWWW WWWW XXXX XXXX YYYY YYYY ZZZZ ZZZZ 2222 2222
3333 3333 4444 4444 OSCD STST QQQQ QQQQ QQQQ QQQQ QQQQ QQQQ QQQQ QQQQ QQQQ QQQQ
....

AIX 6 and above:

hhhh hhhhh EEEE EEEE TTCC vvvv NNNN NNNN NNNN NNNN IIII IIII MMMM MMMM LLLL LLLL
AAAA AAAA BBBB BBBB DDDD DDDD FFFF FFFF GGGG GGGG HHHH HHHH JJJJ JJJJ KKKK KKKK
PPPP PPPP SS%% UUUU VVVV VVVV WWWW WWWW XXXX XXXX YYYY YYYY ZZZZ ZZZZ 2222 2222
3333 3333 4444 4444 5555 5555 5555 RRRR 7777 7777 7777 7777 RRRR RRRR RRRR RRRR OOOO RRRR....
..skip 5 rows RRRR Reserved for future use.
OSCD STST on 1st row of QQQQ's. The following 22 rows are all QQQQ

Mail Box Cmd
The 2nd byte of the data section CD is the command. The valid commands there definition are:

Command CD	Definition	What it means
0x01	Erase Flash and Download Absolute image	If this command times out, and the adapter does not respond following a system boot, this may indicate a damaged flash image. (requires adapter replacement)
0x02	Read Port parameters from NV RAM	Read the adapter set up parameters
0x03	Write Port parameter to NV RAM	Write the adapter set up parameters
0x05	Initialize the link	Initialize Fibre Channel link
0x06	Shut down fibre channel link	Shut down the fibre channel link gracefully
0x07	Configure link parameters	Configure D_ID local address and timers
0x09	Configure cmd ring	Configure IO command block ring
0x0A	Reset cmd ring	Reset IO command block ring
0x0B	Read Port configuration	Read adapter Port configuration
0x0C	Read Ring configuration	Read ring configuration
0x0E	Read status	Read adapter port status
0x01	READ_XRI	Read RXI context
0x11	Read Revision levels	Read SLI port revision information
0x12	Read the Link Status	Read link status (counters, errors ....etc).
0x13	Register Login	Register N_Port login
0x14	Unregister Login by Remote Port ID (RPI)	Unregister N_Port login: Free an RPI context
0x16	Clear Link Attention	Clear link attention condition.
0x17	Dump	Read SLI port internal data
0x1A	Restart	Resume normal operation of SLI Port after selective reset
0x1B	Update Port configuration	Write configuration data entry to none-volatile memory
0x1C	Erase Flash and download relative image	If this command times out, and the adapter does not respond following a system boot, this may indicate a damage flash image. (require adapter replacement)
0x22	Reset Link	Force link reset protocol in non-loop topology
0x23	Unregister logon by destination ID	Unregister login of unknown RPI specified by D_ID of remote port
0x24	Kill Board	Perform graceful shutdown of the board to prepare for reset
0x81	Load Flash Area	If this command times out, and the adapter does not respond following a system boot, this may indicate a damage flash image. (require adapter replacement)
0x88	Configure Port	Provide SLI Port control block to locate and configure interface controls
0x8d	Read Port service Parameters	Read SLI Port service parameters
0x93	Register Login	Register N_Port login: Allocate an RPI context tag.
0x95	Read Link Attention	Read link attention ( sent by the SLI host to read the link attention status when the SLI Port has signed link attention).
0x9C	Load image into flash	If this command times out, and the adapter does not respond following a system boot, this may indicate a damage flash image. (require adapter replacement)

Failed command status: If the error indicates a failed mailbox command, find the failing status in the sense data.

Status	Meaning	What to do
0x0000	Success	Nothing to do unless this was a cmd time out, If the ownership field OS is 0x00, check for an unsupported adapter on the PCI bus or for INTRPPC_ERR in the error log indicating and a problem with AIX or the System.
0x0100	General Failure	Insure that the adapter is properly seating and powered on.
0x0200	Num SAN commands error	This needs to be reviewed by AIX support
0x0300	SAN commands exceeded	This needs to be reviewed by AIX support
0x0400	Invalid ring number specified	This needs to be reviewed by AIX support
0x0500	Invalid number of R_CTL/TYPE matches specified	This needs to be reviewed by AIX support
0x0600	Number of available R_CTL/TYPE matches exceeded	This needs to be reviewed by AIX support
0x0700	Invalid profile number specified	This needs to be reviewed by AIX support
0x0800	bad def class	This needs to be reviewed by AIX support
0x0900	Out-of-range ring specified in the RDRR field	This needs to be reviewed by AIX support
0x0A00	ring range error	This needs to be reviewed by AIX support
0x0C00	No RPI	This needs to be reviewed by AIX support
0x0D00	No Resources	This needs to be reviewed by IOPE support
0x0E00	Receive buffer too small	This needs to be reviewed by AIX support
0x0F00	DMA Error	This needs to be reviewed by IOPE support
0x1000	Command not supported in NoRAM warm start mode	This needs to be reviewed by AIX support
0x1100	Unsupported feature	This needs to be reviewed by AIX support
0x1200	Unknown Mail box command	This needs to be reviewed by AIX support
0xD0	Failure to allocate memory	This needs to be reviewed by AIX support
0xD1	Failure to start DMA	This needs to be reviewed by AIX support
0xD2	Failure to transmit DMA operation	This needs to be reviewed by AIX support
0xD5	Unsupported mailbox command options	This needs to be reviewed by AIX support
0xD6	Failure of control DMA operation	This needs to be reviewed by AIX support
0xD7	Invalid command Sequence	This needs to be reviewed by AIX support.
0xF0	Mailbox command not supported in warm start mode	This needs to be reviewed by AIX support
0xF1	Flash ROM area not available	This needs to be reviewed by AIX support
0xF2	Failure erasing flash ROM sector	Do firmware upgrade failure PD
0xF3	Failure writing Flash ROM byte	Do firmware upgrade failure PD
0xF5	Downloaded image checksum error	Do firmware upgrade failure PD
0x0001	flash write failed	If firmware upgrade, Do firmware upgrade failure PD
0x0005	Invalid link speed selection	This needs to be reviewed by AIX support
0x000A	ring range	This needs to be reviewed by AIX support
0x000F	not active RPI	This needs to be reviewed by AIX support
0x0010	No Active XRI in use	This needs to be reviewed by AIX support
0x0014	RPI not in use	This needs to be reviewed by AIX support
0x0015	no link attn	This needs to be reviewed by AIX support
0x0016	no LA to clear	This needs to be reviewed by AIX support
0x0097	Virtual S_ID is in use (at least one explicitly registered RPI has not been unregistered)	This needs to be reviewed by AIX support
0x00E0	Link Module is not the type with Serial ID	Check for incorrect Link Module
0x00E1	Link Module not plugged in	Plug in the link model
0x00E2	Error accessing Link Module Serial ID data	Check for defective Link Module
0x00F0	Requested RPI not in use	This needs to be reviewed by AIX support
0x0084	Transmit buffer larger than receive buffer (receive length transferred)	This needs to be reviewed by AIX support
0x0110	Requested XRI not in use	This needs to be reviewed by AIX support
0x0116	Not the last link attention pending (the input event tag is less than the current link event counter)	This needs to be reviewed by AIX support
0x0188	Cannot issue CONFIG_PORT again without resetting the SLI Port.	This needs to be reviewed by AIX support
0x1100	Unsupported feature (N_Port vitalization is not enabled)	This needs to be reviewed by AIX support
0x2000	Unknown virtual S_ID (the virtual S_ID is not currently registered)	This needs to be reviewed by AIX support
0x0284	Invalid BDE (nothing transferred)	This needs to be reviewed by AIX support
0x1400	PCB not 32-bit word aligned	This needs to be reviewed by AIX support
0xFF00	Not finished	This needs to be reviewed by AIX support